Plugin: Clean Spellbook
Autor: Low Post
Version: 1.3.0
__________________________________________________________________________________________
1. Beschreibung
2. Installation
3. Bekannte Probleme
4. Weiterverwendung/Verffentlichung
5. Kontakt
6. Changelog
7. Credits

===============
1. Beschreibung
===============

Mit zunehmenden Spielverlauf wird das Zauberbuch des Inventars immer voller. Meistens sogar 
nur mit Sprchen, die man eigentlich gar nicht verwendet. Schlimmstenfalls ist es sogar so 
zugemllt, dass man seine Lieblingsprche gar nicht mehr wiederfindet, da z.B. auf einen 
ntzlichen 5 absolut unbrauchbare Sprche kommen.
Genau hier kommt dieses PI in's Spiel: es fgt ein Zauberbuch dem Spiel hinzu, in dem man 
sich seine Zauber, nach Zauberschulen geordnet, ansehen und auf Wunsch einzelne, eine ganze 
Kategorie, oder gleich alle Sprche vergessen kann.
Vergessene Sprche werden aber nicht gelscht, sie werden gespeichert (quasi im Zauberbuch 
niedergeschrieben) und knnen auf Wunsch wiedererlernt/hinzugefgt werden. Auch hier 
funktioniert das fr einzelne Sprche, Sprche einer Kategorie, bzw. alle Sprche zusammen.
'Vergessene' Sprche werden immer mit einem '(Versteckt)' in der Zeile nach dem Namen des 
Spruches gekennzeichnet.

Es gibt folgende Kategorien:
	* Beschwrung
	* Illusion
	* Mystik
	* Vernderung
	* Wiederherstellung
	* Zerstrung
	* Geringe Macht

Es ist nicht mglich Groe Mchte, Fhigkeiten, oder Krankheiten zu vergessen (werden gar 
nicht angezeigt), da ich hier A in Balancing-Bereiche massivst eingreifen wrde und 
B wahrscheinlich noch jede Menge anderer Probleme heraufbeschwren wrde.
Beides ist von diesem PI nicht erwnscht, es soll einfach dem Spieler helfen sein Zauberbuch 
sauber zu halten.
Zustzlich ist es nun mglich mit dem Zauberbuch Sprche auszursten. Dazu muss man whrend 
man den Spruch anklickt den SelectKey (Standard: L-Shift) gedrckt halten.
Der SelectKey ist einstellbar, indem man die gewnschte neue Taste gedrckt hlt und 
gleichzeitig im Hauptmen den Beenden Button drckt.
Wenn man den momentan ausgersteten Zauber erneut mit gedrcktem SelectKey anklickt wird 
dieser als HotSpell markiert. HotSpells werden im Zauberbuch vor den normalen Sprchen 
angezeigt und knnen so leichter gefunden werden. Um einen HotSpell wieder von seinem Status 
zu befreien muss er mit gedrckten SelectKey angeklickt werden, whrend er entweder als 
Aktueller Zauber ausgewhlt, oder momentan versteckt ist.

Auerdem ist es mglich sich weitere Informationen ber die einzelnen Zauber anzeigen zu 
lassen, sowie alle versteckten Zauber nach den nicht-versteckten anzuzeigen (versteckte 
HotSpells werden immer noch vor den normalen nicht-versteckten Zaubern angezeigt).
Diese optionalen Features lassen sich ber ein eigenes Untermen an-, bzw. abstellen. Dieses 
Untermen wird aufgerufen, indem man mit gedrcktem SelectKey im Hauptmen den Beenden Button 
anklickt. Alles weitere wird dann dort erklrt.
Auerdem kann man dort sowohl die Sprache, als auch das Material, aus dem die Seiten des 
Zauberbuchs gemacht sind, ndern.

				ACHTUNG:
	Das Zauberbuch ist kein Buch sondern ein Misc Item. Deshalb muss auch nach einem 
		Misc Item anstelle eines Buches gesucht werden.

Clean Spellbook ist sowohl in englischer, als auch in deutscher Sprache verwendbar.
Sollte Pluggy v122 (oder hher) installiert sein wird die Sprache automatisch anhand der 
Dateigre der Oblivion.esm bestimmt, ansonsten anhand dem Wert von iLanguage [Controls] in 
der Oblivion.ini.
				ANMERKUNG:
	Sollte der Wert nicht mit der gewnschten Sprache bereinstimmen kannst du das 
	durch folgenden Konsolenbefehl ndern (bzw. ber o.g. Untermen):
		set LPCSBLanguage to [Zahl der gewnschten Sprache]
	Hier ist eine Liste, welche Sprache bei welchen Werten gewhlt wird:
		LPCSBLanguage == 1	--> Deutsch
		alles andere		--> Englisch

Das Zauberbuch lsst sich sowohl aus dem Inventar heraus, als auch frei in der Welt 
herumliegend aktivieren. Das wurde eingebaut, damit man es auch in ein Bcherregal stellen und 
es trotzdem benutzen kann.
Das wirft aber das Problem auf, dass man es nicht mehr ganz normal aufnehmen kann. Dazu muss 
man einfach whrend man das Zauberbuch aktiviert den SelectKey gedrckt halten.

===============
2. Installation
===============

Das Archiv ist OMOD-Ready, d.h. du musst im OBMM nur eine neue Omod erstellen und das Archiv 
hinzufgen, der OBMM erledigt dann den Rest. Um es zu installieren aktiviere dann einfach die 
eben erstellte OMOD.

Falls du keine Omod verwenden willst kopiere die 'Clean Spellbook.esp' und die 
'Clean Spellbook.bsa' in deinen '...\Oblivion\Data'-Ordner und aktiviere die *.esp im 
Oblivion-Laucher.

ACHTUNG: Dieses PI bentigt OBSE v0016 (oder hher).

Deinstallation:
---------------
Omod-User mssen einfach die Omod deaktivieren und anschlieend lschen.

Nicht Omod-User mssen die 'Clean Spellbook.esp' sowie die 'Clean Spellbook.bsa' aus ihrem 
'...\Oblivion\Data'-Ordner lschen.

ACHTUNG: Zum Zeitpunkt der Deaktivierung vergessene Sprche knnen nicht wieder hinzugefgt 
	 werden.

Update:
-------
Es sollte reichen die alten Dateien einfach mit den neuen zu berschreiben.
Wer auf Nummer sicher gehen will kann natrlich trotzdem ein Clean Save machen:
	 1.	Alle Zauber zeigen & das Spiel speichern
	 2.	Alte Version deinstallieren
	(2.b	Spiel starten und in neuem Slot speichern)
	 3.	Neue Version installieren

====================
3. Bekannte Probleme
====================

 - Bei "Zauberhndlern" kann man vergessene Sprche kaufen
 - Die Zauber werden nicht immer in alphabetischer Reihenfolge angezeigt
   Das passiert vor allem, wenn ein Spruch als HotSpell markiert wird/von diesem Status 
   "befreit" wird
 - Der Effekt eines Zaubers wird nicht richtig angezeigt, falls er ein Attribut, oder eine 
   Fertigkeit beeinflusst
   Evtl. wird das in einer zuknftigen OBSE-Versionen gefixt
 - Wenn man zu viele Effekte anzeigen lsst kommt es vor, dass die MessageBox nicht mehr 
   vollstndig in's Bild passt. Es ist aber immer noch mglich mit Hilfe der Pfeiltaste 
   zwischen den verschiedenen Buttons zu navigieren und so das Men zu verlassen.
   Der letzte Button ist immer der Beenden-Button.
 - Sofern man kein Plugin verwendet, dass die Schrift verkleinert passt das Untermen fr die 
   Einstellungen des Zauberbuchs nicht in das Bild.
 - Sollte die gesammte MessageBox mehr als 4096 Zeichen haben kann es zu CTDs kommen, 
   normalerweise sollte das aber kein Problem darstellen, da selbst eine Seite voller Zauber 
   mit jeweils 5 Effekten diese Zeichenzahl nicht erreicht wird.
   Die maximal mgliche Zeichenzahl kann ich leider nicht beeinflussen, da das durch OBSE 
   definiert wird. Evtl. ndert sich diesbezglich in der Zukunft noch etwas.

====================================
4. Weiterverwendung/Verffentlichung
====================================

Solange ihr keine Dateien aus dem Archiv verndert oder entfernt knnt ihr das PI jederzeit 
bei euch hochladen. Schreibt mir aber bitte eine Nachricht mit dem Downloadlink (auf eine 
extra-Erlaubnis msst ihr nicht warten).

Falls ihr irgentwelche anderen Sachen mit dem PI machen wollt fragt einfach nach. 
Keine Angst, ich bei nicht. ;)


Sollte ich eines Tages das Oblivion-Modding eingestellt haben und ihr etwas anderes mit diesem 
Plugin machen wollt als einfach nur hosten fragt zuerst einmal nach. ;)
Solltet ihr mich nicht erreichen (sprich: keine Antwort meinerseits innerhalb eines Monats 
oder mehr bei Ausschpfung aller unten angegebenen Kontaktmglichkeiten) knnt ihr 
meinetwegen machen was ihr wollt, solange ihr angemessene Credits gebt.

==========
5. Kontakt
==========

Ihr knnt mich in diesen Foren unter dem Nick 'Low Post' via PN erreichen:
http://www.multimediaxis.net/index.php
http://www.elderscrollsgames.de/distribution/
http://forum.newraven.net/
http://forum.worldofplayers.de/forum/index.php
http://www.scharesoft.de/joomla/forum/index.php
http://www.bethsoft.com/bgsforums/

Auerdem knnt ihr mir auch eine Mail schreiben: <spamviech@web.de>

============
6. Changelog
============

1.3.0:	- Verbesserte Version von Mesh & der Texturen fr das Zauberbuchs. (Danke an Katan)
		* Umschalten der Seitenfarbe im Einstellung-Untermen mglich.
	- Umstellen auf Strings u.a. um ein direktes Einbinden von StringGameSettings zu 
	  ermglichen.
	- Sollte Pluggy installiert sein wird die Sprache anhand der Gre der Oblivion.esm 
	  ermittelt.
	- Die Sprache lsst sich jetzt auch im Einstellungs-Untermen einstellen.
	- Ein paar interne Vernderungen (nur noch eine Faction pro Sprache).

1.2.1:	- Fixen eines Bugs, wodurch kein Effekt eines Zaubers angezeigt wurde wenn man 'Alle '
	  gewhlt hat.

1.2.0:	- Das Zauberbuch kann nun auch aktiviert werden, wenn es frei in der Welt rumliegt 
	  (z.B. in einem Bcherregal)
		* durch drcken des SelectKeys wird es dem Inventar hinzugefgt
	- Die Reihenfolge in der die Sprche angezeigt werden wird nun immer sofort 
	  aktualisiert
	- HotSpells
		* Zauber werden als HotSpell markiert, indem man auf einen bereits 
		  ausgersteten Zauber mit gedrcktem SelectKey klickt.
		* HotSpells werden immer am Anfang der jeweiligen Gruppe angezeigt, egal ob 
		  sie versteckt wurden oder nicht.
			 Falls LPCSBMoveHiddenToBack != 0 ist werden versteckte HotSpells am 
			  Ende der HotSpells angezeigt
		* Um einen HotSpell wieder zu einem normalem Zauber zu machen muss man ihn 
		  als aktuellen Zauber, oder im versteckten Zustand mit gedrcktem 
		  SelectKey anklicken.
	- Informationen ber den jeweiligen Zauber werden angezeigt:
		* Weiterhin, ob der Zauber versteckt wurde
		* Der momentan ausgerstete Zauber wird angezeigt
		* Alle Effekte eines Zaubers mit (falls vorhanden) Strke (Magnitude), 
		  Bereich (Area), Lnge (Duration) & Ziel (Range)
		* Magickakosten (inkl. aktuellem Magickawert) & der bentige Fertigkeitslevel 
		  (falls erfllt wird nur die Magieschule angezeigt)
		* Ob ein Zauber feindlich ist (Hostile)
		* Alle Informationen (auer Aktueller Zauber/Versteckt/HotSpell) sind optional 
		  und standardmig deaktiviert. Die zustndigen Globals sind:
			 LPCSBShowEffects
			 LPCSBShowHostility
			 LPCSBShowMagickaCost
			 LPCSBShowMagicSchool
	- Hinzufgen eines Auswahlmens, in dem man alle Globals (auer LPCSBLanguage) 
	  einstellen kann. Um es aufzurufen muss man im Hauptmen den SelectKey gedrckt 
	  halten, whrend man auf Beenden klickt.

1.1.4:	- Fixen eines Bugs, der das Anzeigen der ersten MessageBox verhinderte sofern Pluggy 
		nicht installiert wurde.

1.1.3:	- Fixen einiger Rechtschreibfehler (DV)
	- Fixen eines mglichen CTDs (EV)

1.1.2:	- Fixen eines Bugs beim anzeigen des SelectKeys, wodurch bei bestimmten Tasten 
		(z.B. Tab) nichts angezeigt wurde.

1.1.1:	- Fixen eines Bugs bei der berprfung von OBSE
	- Hinzufgen von LPCSBLanguage
	- Optional: beheben eines Fehlers, wodurch die falsche Taste zum auswhlen eines 
		Zaubers angezeigt wurde (nicht QWERTY-Keyboards).
		Bentigt Pluggy 85 oder hher.

1.1.0:	- Versteckte Sprche werden nun nach den noch  vorhandenen angezeigt (optional).
		Dieses Feature lsst sich ber folgenden Konsolenbefehl aktivieren:
			set LPCSBMoveHiddenToBack to 1
	- Button um alle Zauber einer Gruppe zu verstecken/zeigen wird nur noch auf der 
		ersten Seite angezeigt.
	- Auf jeder Seite wird nun ein Button zum Beenden des Spellbooks angezeigt
	- Es ist nun auch mglich das Spellbook via HotKey zu verwenden
	- Es ist nun mglich Sprche auszursten, wenn man eine einstellbare Taste
		(Standart: Linke Shift-Taste) gedrckt hlt, wrend man den Spruch auswhlt.
	- Fixen eines Bugs, wodurch Startsprche ausgerstet blieben, obwohl man sie 
		vergessen hat.

1.0.6:	- Korrigieren einiges Scriptfehlers, der ein drittes Aktivieren des Spellbooks 
		unmglich gemacht hat.

1.0.5:	- Anzeigen des Spellbook-Icons und der OBSE-berarbeitung im Starttext, sofern 
		OBSE v0015 (oder hher) installiert ist.

1.0.4:	- Verwendung der OBSE-Befehle AddSpellNS & RemoveSpellNS, um das ausblenden anderer
		Messages zu verhindern, sofern OBSE v0015 (oder hher) installiert ist.

1.0.3:	- Fixen eines Bugs in den Untermens fr Beschwrung, Illusion, 
		Vernderung & Zerstrung (EV)

1.0.2:  - Fixen eines Bugs im Mystikuntermen (EV)
	- Befreien des Spellbooks von seinem Questitem-Status
	- Hinzufgen eines Meshs/Icons fr das Spellbook (thx an Katan)

1.0.1:	- Automatisieren der Auswahl der Sprachversion

1.0:	- Erstes Release

==========
7. Credits
==========
 - Katan dafr, dass er mich auf die Idee gebracht hat (wenn auch eher unabsichtlich ;) )
 - Nochmal Katan, diesmal fr das Testen des PIs
 - ein drittes mal Katan, diesmal fr anfertigen von Mesh, Textur & Icon fr das Zauberbuch
 - Muecke49, ebenfalls fr das Testen des PIs
 - allnet & SirTroy, auch fr das Testen des PIs
 - Dem OBSE-Team, die das erst ermglicht haben.
 - Elys fr Pluggy. StringToTxtFile macht debugging um so vieles einfacher. :)
 - GlasMond, weil er ganz schreckliche Dinge macht, wenn ich ihn nicht erwhne